home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / sstev.z / sstev
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSTTTTEEEEVVVV((((3333FFFF))))                                                            SSSSSSSSTTTTEEEEVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSTEV - compute all eigenvalues and, optionally, eigenvectors of a real
  10.      symmetric tridiagonal matrix A
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE SSTEV( JOBZ, N, D, E, Z, LDZ, WORK, INFO )
  14.  
  15.          CHARACTER     JOBZ
  16.  
  17.          INTEGER       INFO, LDZ, N
  18.  
  19.          REAL          D( * ), E( * ), WORK( * ), Z( LDZ, * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      SSTEV computes all eigenvalues and, optionally, eigenvectors of a real
  23.      symmetric tridiagonal matrix A.
  24.  
  25.  
  26. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  27.      JOBZ    (input) CHARACTER*1
  28.              = 'N':  Compute eigenvalues only;
  29.              = 'V':  Compute eigenvalues and eigenvectors.
  30.  
  31.      N       (input) INTEGER
  32.              The order of the matrix.  N >= 0.
  33.  
  34.      D       (input/output) REAL array, dimension (N)
  35.              On entry, the n diagonal elements of the tridiagonal matrix A.
  36.              On exit, if INFO = 0, the eigenvalues in ascending order.
  37.  
  38.      E       (input/output) REAL array, dimension (N)
  39.              On entry, the (n-1) subdiagonal elements of the tridiagonal
  40.              matrix A, stored in elements 1 to N-1 of E; E(N) need not be set,
  41.              but is used by the routine.  On exit, the contents of E are
  42.              destroyed.
  43.  
  44.      Z       (output) REAL array, dimension (LDZ, N)
  45.              If JOBZ = 'V', then if INFO = 0, Z contains the orthonormal
  46.              eigenvectors of the matrix A, with the i-th column of Z holding
  47.              the eigenvector associated with D(i).  If JOBZ = 'N', then Z is
  48.              not referenced.
  49.  
  50.      LDZ     (input) INTEGER
  51.              The leading dimension of the array Z.  LDZ >= 1, and if JOBZ =
  52.              'V', LDZ >= max(1,N).
  53.  
  54.      WORK    (workspace) REAL array, dimension (max(1,2*N-2))
  55.              If JOBZ = 'N', WORK is not referenced.
  56.  
  57.      INFO    (output) INTEGER
  58.              = 0:  successful exit
  59.              < 0:  if INFO = -i, the i-th argument had an illegal value
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSTTTTEEEEVVVV((((3333FFFF))))                                                            SSSSSSSSTTTTEEEEVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.              > 0:  if INFO = i, the algorithm failed to converge; i off-
  75.              diagonal elements of E did not converge to zero.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.